std::forward_list::splice

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++0x feature) Atomic operations library (C++0x feature) Thread support library (C++0x feature)
Containers library
array (C++0x feature) vector deque forward_list (C++0x feature) list set multiset map multimap unordered_set (C++0x feature) unordered_multiset (C++0x feature) unordered_map (C++0x feature) unordered_multimap (C++0x feature) stack queue priority_queue
std::forward_list
Member functions forward_list::forward_list forward_list::~forward_list forward_list::operator= forward_list::assign forward_list::get_allocator Element access forward_list::front Iterators forward_list::before_begin forward_list::cbefore_begin forward_list::begin forward_list::cbegin forward_list::end forward_list::cend Capacity forward_list::empty forward_list::max_size Modifiers forward_list::clear forward_list::insert_after forward_list::emplace_after forward_list::erase_after forward_list::push_front forward_list::emplace_front forward_list::pop_front forward_list::resize forward_list::swap Operations forward_list::merge forward_list::splice forward_list::remove forward_list::remove_if forward_list::reverse forward_list::unique forward_list::sort

​void splice(const_iterator pos, forward_list& other);​	(1)	(C++0x feature)
​void splice(const_iterator pos, forward_list&& other);​	(1)	(C++0x feature)
​void splice(const_iterator pos, forward_list& other, const_iterator it);​	(2)	(C++0x feature)
​void splice(const_iterator pos, forward_list&& other, const_iterator it);​	(2)	(C++0x feature)
​void splice(const_iterator pos, forward_list& other,             const_iterator first, const_iterator last);​	(3)	(C++0x feature)
​void splice(const_iterator pos, forward_list&& other,             const_iterator first, const_iterator last);​	(3)	(C++0x feature)

Moves elements from one list to another.

No elements are copied. The behavior is undefined if: ​get_allocator() != other.get_allocator()​, or ​this == &other​. No iterators or references become invalidated, the iterators to moved elements now refer into ​*this​, not into other.

1) Moves all elements from other into ​*this​. The elements are inserted before the element pointed to by pos. The container other becomes empty after the operation.

2) Moves the element pointed to by it from other into ​*this​. The element is inserted before the element pointed to by pos.

3) Moves the elements in the range [first, last) from other into ​*this​. The elements are inserted before the element pointed to by pos.

Contents 1 Parameters 2 Return value 3 Example 4 Complexity 5 See also

Parameters

pos	-	element before which the content will be inserted
other	-	another container to move the content from
it	-	the element to move from other to ​*this​
first, last	-	the range of elements to move from other to ​*this​

Return value

(none)

Example

This section is incomplete

Complexity

constant

See also

merge	merges two sorted lists (public member function)
remove	removes elements with specific value (public member function)
remove_if	removes elements satisfying specific condition (public member function)